home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_game / usurp014.zip / SYSOP.DOC < prev    next >
Text File  |  1996-03-03  |  23KB  |  523 lines
  1.  
  2.  *******************************************
  3.  **** Usurper 0.14, Sysop Documentation ****
  4.  *******************************************
  5.  
  6. Program Information :
  7.  
  8.  Door     - Usurper v0.14
  9.  Producer - (c) 1993-1996 JAS Software, All Rights Reserved
  10.  Using    - Borland Pascal 7.0 and DDplus 7.0
  11.                         
  12. Acknowledgements :
  13.  DDplus      - Distributed by Steve Lorenz and Bob Dalton - 1995
  14.  
  15. (Copyright 1993-1996 Jakob Dangården and JAS Software, All Rights Reserved)
  16.                             
  17. [*** This file is also available in German, see --> German.doc          ***]
  18. [*** Address for the Usurper home-page is:  http://www.xs4all.nl/~codex ***]
  19. [*** responsible for the WEB page is Rico Tijsen. THANKS!               ***]
  20.  
  21. Usurper on InterNet:
  22. --------------------
  23. The latest version of Usurper is now available on the Internet via anonymous
  24. FTP on ftp.asogy.stockholm.se in the directory \pub\bbs\usurper
  25.  
  26.  
  27.  
  28.  
  29. Disclaimer
  30. ----------
  31. The Usurper Door is distributed without warranty.
  32. In no case shall I be held responsible for any damages or losses
  33. resulting from you running this software. By running this program
  34. you have agreed to take responsibility for any problems that may result.
  35. If you do not agree to this, don't run the program.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41. Usurper ? 
  42. ---------
  43. Usurper is a ANSI/ASCII doorgame which requires approximately 230k of free
  44. memory to run.
  45.  
  46. Usurper is a fastpaced doorgame which only has one purpose :
  47. to give its players a moment of joy and relaxation. It only
  48. takes a couple of minutes to play each day, it's easy to understand
  49. and the gameplay is straightforward. Get bigger, meaner and stronger.
  50. The settings are a fantasy scenario inhabited with
  51. different races and creatures. The game can be completed when
  52. a player reaches the darkest dungeon at the bottom of the big
  53. mountain. He then gets immortalized. However, players can also
  54. struggle for earthly power. They can form teams who fight eachother
  55. for gangland. Computer characters can also be sworn into the teams.
  56. characters can be played good or bad with different results and
  57. races have their own special abilities and weapons. 
  58.  
  59. WARNING! Usurper sometimes confront the players with brutal violence,
  60. sex and drugs. IF you feel offended, have any doubts or objections :
  61. don't run this door! If you like parts of the game but don't want the
  62. nasty ones, You can turn off the asocial features with the
  63. configuration program. 
  64.                             
  65.  
  66.  
  67.  
  68. Installation
  69. ------------
  70.  
  71. Make a subdirectory called USURPER or something else that comes to mind.
  72. Unzip all files in the Usurper.zip archive to this
  73. directory. 
  74.  
  75. The next thing you should do is to run the EDITOR.EXE
  76. program. Choose the [G]ame Reset option and all the
  77. necessary datafiles will be created.
  78. Now select the CONFIGURATION option. Browse the different options
  79. and edit the ones you need.
  80.  
  81. The configuration (USURPER.CFG) is a ASCII text file. You can
  82. edit it with a text-editor, but I recommend that you use the EDITOR.EXE
  83. to change any options.
  84.  
  85.  
  86.  
  87.  
  88. The USURP.CTL file(s)
  89. ---------------------
  90. Depending on your system, multinode or single system, you might wish to
  91. create more than one .CTL file. If you have different modem setups on 
  92. your lines then you must create a USURPx.CTL file for every line Usurper
  93. can run on (x is representing a number, USURP1.CTL is used for node 1 and
  94. so on ... ).
  95.  
  96. Single line systems should only need USURP.CTL
  97. A 3 node system with different modem setups will need
  98.     USURP1.CTL,    
  99.     USURP2.CTL,
  100.     and USURP3.CTL.
  101.  
  102. The USURP.CTL file is quite self explanatory and can be easily edited
  103. with a texteditor. However, there is an alternative editor that can
  104. do the work for you ;
  105.   
  106.     Unzip the DDSETUP.ZIP package in the game directory. Type the
  107.     Command "DDSETUP" and then the enter key.  When asked for the
  108.     name of the control file enter "USURP.CTL" and hit the F5 key
  109.     or click on the continue button to continue to the next page.
  110.     Use the on-line help key (F1) or click on the Help button for
  111.     anything you do not understand how to fill out.  There is a
  112.     DDSETUP.DOC provided if you need further information on how
  113.     to use the DDSETUP.EXE program. Two fully commented versions
  114.     are also provided. One is identified as GAME.CTL and this is the
  115.     UN-EDITED version  and the other is identified as SAMPLE.CTL is
  116.     what a CTL file should look like AFTER it is edited (if the commented
  117.     lines are left in that is).  If for some reason the DDSETUP.EXE
  118.     program fails to work on your system you can always manually edit one
  119.     of the two examples provided and rename the one you use to
  120.     "USURP.CTL".
  121.  
  122.     Where to put this file?
  123.     Put this file wherever you are running the game executable file from.
  124.     If you are running multi-node you could put a copy in each node
  125.     directory and run from there.  If you change directory to the GAME
  126.     directory put the file here.  Examples of .BAT files for both single
  127.     and multi node systems are given in this document (if you keep on
  128.     reading :).
  129.  
  130.  
  131. Have you set up your USURP.CTL file according to the instructions?
  132.  
  133. Well, if you have that should be it! Now you can try to run Usurper with ;
  134. Usurper.Exe /L, and see if everything works.                    
  135. Maintenance takes place automatically when needed. Since it can take
  136. quite some time you can disable the automatic maintenace with the Editor.exe
  137. program. Instead you can force Usurper to do its daily maint with the
  138. command line option '/FMAINT' (command line options are explained more
  139. in a special section in this document).
  140.  
  141.  
  142.  
  143. Helpfiles
  144. ---------
  145.  DDSET661.ZIP - Compressed copy of the DDSETUP.EXE program and associated
  146.                 files. You can use this to make your USURP.CTL game
  147.                 configuration file, otherwise use a texteditor.
  148.  
  149. Files created and used by Usurper: (USURPER/DATA)
  150. ----------------------------------
  151. Armor.dat       => All armors for Usurper when running in CLASSIC mode.
  152. Banksafe.dat    => All information of whats in the bank vault.
  153. Comments.dat    => Conversations at the Inn (ascii).
  154. Date.dat        => Needed for Usurper to know when it's time to run
  155.                    maintenance.
  156. Fame.dat        => All heros that have completed the game (ascii).
  157. Guards.dat      => Guards that can be hired for protection when staying at
  158.                    the Inn. 
  159. Gods.dat        => When a player completes the game he can choose to become
  160.                    a God. The Gods are stored in this file. Erasing this file
  161.                    will "only" vipe Usurper clean from immortals. 
  162. Levels.dat      => Information of the experience needed to raise a level.
  163. Mail.dat        => Various information posted to players.
  164. Maint.flg       => This file is created when Usurper is running it's 
  165.                    maintenance. It's created to prevent other nodes access
  166.                    to the game. As with the above ONLINERS.DAT file this file
  167.                    can be leftover after a computer lockup or some other
  168.                    strange reason. 
  169. Monster.dat     => Usurper dungeon monsters. Comlete with weapons and all.
  170. News.dat        => What has happened today? (ascii).
  171. Npcs.dat        => The Non Player Controlled characters. 
  172. Objdat01-15.dat => All weapons,armors and other items for Usurper when
  173.                    running in NEW mode.
  174. Onliners.dat    => This file contains all information of who is playing
  175.                    the game right now. Even if nobody is playing the game
  176.                    this file can exist. It is removed only at maintenance.
  177.                    There can be times when you would like to remove this
  178.                    file. For example : If somebody is playing Usurper and
  179.                    the system goes down because of a computer lockup, or
  180.                    or some other reason, the game will report this user as
  181.                    playing when he/she is in fact trying to enter again!
  182.                    It is perfectly safe to erase the ONLINERS.DAT file when
  183.                    nobody really is playing.
  184.  
  185. Teamrec.dat     => Which gang has held the town for the longest time.  
  186. Trecord.dat     => Hall of Fame for teams holding the town (ascii).
  187. Users.dat       => Information of all gamers.
  188. Wanted.dat      => Who is wanted and how much are their stinking heads worth.
  189. Weapon.dat      => All weapons for Usurper when running in CLASSIC mode.  
  190. Ynews.dat       => What happened yesterday (ascii).
  191. Tnames.dat      => Names used by computer players when forming teams.
  192.                    A textfile which can be edited if you wish.
  193. ERROR.LOG      => All error messages are put in this file.
  194.  
  195.  
  196.  
  197. To run Usurper
  198. --------------
  199. Batch File EXAMPLE for Usurper
  200.   This is few samples of batch files to be used with Usurper
  201.   %1 is the Node Number which the BBS software passes to the
  202.   batch file.
  203.                     
  204.   *** Example batch for a Multinode system START ***
  205.  
  206. REM The /M1 option tells Usurper to look for the USURP1.CTL file.
  207. REM The /M2 option tells Usurper to look for the USURP2.CTL file ...
  208. REM If you remove the /M switch then Usurper will look for USURP.CTL
  209. REM The /P option forces Usurper to look for the dropfile in the given
  210. REM directory.
  211.              
  212. CD \BBS\DOORS\USURPER   
  213. USURPER /M%1 /PC:\BBS\NODE%1
  214.  
  215.   *** Batch file example END ***                
  216.  
  217.  
  218.   *** Example batch for a Single node system START ***
  219.  
  220. REM The /P option forces Usurper to look for the dropfile in the given
  221. REM directory.
  222.              
  223. CD \BBS\DOORS\USURPER   
  224. USURPER /PC:\BBS
  225.    *** Batch file example END ***                
  226.  
  227.  
  228.  
  229. NOTE! You can also look at the samples file included :
  230.   MULTI1.BAT - RemoteAccess example 
  231.   MULTI2.BAT - PcBoard example
  232.                             
  233.  
  234.  
  235. Command Line Parameters
  236. -----------------------
  237.  
  238.       "/Bxxxxx"   This tells GAME.EXE to lock its baud rate at
  239.       xxxxx.  In order to get the most efficiency out of a high speed
  240.       error correcting modem (9600 baud or above), you may lock the baud
  241.       rate to a speed higher than what the caller is actually using.
  242.       By locking the baud to say 38,400, the modem can compress text data
  243.       that is being sent and achieve a baud rate much higher than the
  244.       actual transmission rate.
  245.       This will lock the baud rate at the same value for all nodes that
  246.       use this command line.  If you perfer a more selective way to lock
  247.       baud use 'LOCKBAUD' command in the USURP.CTL file.
  248.  
  249.       "/Cx"     (where x is 1..4) This specifies a comport number.
  250.       Some bbs software does not create door information files (dropfiles)
  251.       that contain the comport number.  If your bbs does have a comport
  252.       listed in the dropfile then there is no need for this parameter.
  253.       The default is comport 0, local mode.
  254.  
  255.       "/E" - Expanded Memory Specification If your machine has over one
  256.       megabyte of memory, then you may have some available. USURPER.EXE can
  257.       utilize EMS to improve game performance and reduce conventional
  258.       memory requirements.
  259.       This command will tell USURPER to use EMS memory to hold its
  260.       overlay buffer.  Otherwise disc area may be used to hold this buffer.
  261.       This needs a memory manager and when enabled and is compatible with
  262.       DESQview.
  263.  
  264.       "/X" - Expanded Memory Specification If your machine has over one
  265.       megabyte of memory, then you may have some available. USURPER.EXE can
  266.       utilize XMS to improve game performance and reduce conventional
  267.       memory requirements.
  268.       This command will tell USURPER to use XMS memory to hold its
  269.       overlay buffer.  Otherwise disc area may be used to hold this buffer.
  270.       This needs a memory manager and when enabled and is compatible with
  271.       DESQview. (XMS memory is faster than EMS memory).
  272.       You can't use both /E and /X togheter. 
  273.  
  274.       "/L"      This tells USURPER to load up in LOCAL mode.
  275.       This is good for testing or when a sysop just wants to "try out" the
  276.       door without messing with his BBS setup.  The "/L" mode will ask the
  277.       user for his name and run the door in local mode.
  278.  
  279.       "/Nx"     (where x is 1..9) This specifies a "node number".
  280.       Some bbs software support multinode environments in which you must
  281.       know the node number of the drop file to use. For example, RBBS-PC
  282.       uses DORINFOx.DEF. If you specified "/N2" then USURPER would use
  283.       DORINFO2.DEF.
  284.  
  285.       "/Mx"     (where x is up to 2 filename acceptable characters)
  286.       Used to specify one of Multiple control files.  If you have created
  287.       more than one GAME.CTL file (GAME1.CTL, GAME2.CTL, etc.) for each
  288.       node or network PC then you can select the one you want by using
  289.       the /M parm.
  290.       Example:  "/M2" will force USURPER.EXE to use USURP2.CTL.
  291.  
  292.       "/Pyyy"   This specifies the path to the drop files.
  293.       For example, "/PC:\WILDCAT\WCWORK\NODE1" would tell USURPER to
  294.       look for the drop file in C:\WILDCAT\WCWORK\NODE1. If this is left
  295.       out the program assumes the drop file is local.
  296.  
  297.       "/V"    This command will tell USURPER not to show any display
  298.       on the local screen.  Only a colored screen and a message will be
  299.       displayed.  The cursor will not move as it will be turned off.
  300.       Saves a little processing on multi-tasking systems.
  301.  
  302.       "/W"      This flags the program that a network is present even
  303.       though no multitaskers are detected.  This is useful if the door is
  304.       run on a network such as Novell that doesn't use multitaskers.
  305.       
  306.       "/FMAINT"    This command is only useful if you have disabled the
  307.                 automatic maintenance. /FMAINT will only start maint
  308.                 if it is necessary. It will not run maintenance more than
  309.                 once a day.
  310.    
  311.       "/HMAINT" This command will unconditionally force Usurper to perform
  312.                 maintenance. 
  313.  
  314.       "/SCORES" This command will create any external score files
  315.                 defined with the Editor.EXE program.
  316.  
  317.  
  318.  
  319. Multinode use
  320. -------------
  321.  This game supports multinode use and provides automatic multi-tasker
  322.  support  (time slice releasing) for a wide variety of multi-taskers.
  323.  
  324.            Common Problems (Locked Bauds, High Speed modems, etc)
  325.            ------------------------------------------------------
  326.  
  327.  1.   The game does NOT require a fossil driver to run.
  328.  
  329.  2.   If you are running a high speed modem (9600 baud or above), then I
  330.       suggest you run your bbs/mailer/doors at a locked baud rate. On high
  331.       speed error correcting modems, locking the baud rate will have a
  332.       noticeable increase on the speed of text that is sent. It's beyond
  333.       the scope of this document to discuss configuring your BBS and
  334.       mailer for a locked baud rate; you may wish to consult those docs
  335.       for information on that. Here are a few things to keep in mind when
  336.       setting up GAME with a locked baud rate:
  337.  
  338.       a.  When using a locked baud rate, I highly recommend using a FOSSIL
  339.           driver. This game will work at high speeds without one though.
  340.           BNU is a good fossil driver which can even be loaded and unloaded
  341.           before and after you run this game.
  342.  
  343.       b.  If you are using a fossil, then make sure to tell the fossil
  344.           that the port is locked. For BNU, to lock com1: at 38,400, you
  345.           would use something like "L0=38400" on BNU's command line.
  346.  
  347.       c.  If you lock the baud for one program, it must be locked
  348.           for everything. You can't lock the baud for just this game, but
  349.           not your BBS/mailer.
  350.  
  351.       d.  You may need to use the /B switch on the game.exe Command line
  352.           to specify the locked baud rate. For 19,200 this would be "/B19200"
  353.           and for 38,400 this would be "/B38400". Please note there is no
  354.           space between the "/B" and the baud rate.
  355.  
  356.  3.   What follows is some information on possible strange situations
  357.       that may occur:
  358.  
  359.       a.  Low speed users can play the game, but high speed users get
  360.           garbage.
  361.      
  362.           - If you are not using the DORINFOx.DEF or DOOR.SYS drop file
  363.             then you may wish to find a converter program to convert
  364.             whatever drop file your BBS produces to the DORINFOx.DEF
  365.             or DOOR.SYS format and tell game.exe to use that.
  366.  
  367.             Several converter programs are readily available on most
  368.             BBS systems. CallDoor is a good one if you can find it.
  369.  
  370.       b.  The game hangs up when a user enters the game.
  371.  
  372.           - Sounds like the game is getting the wrong baud rate somehow.
  373.             Try switching over to the DOOR.SYS drop file method
  374.             if possible.
  375.  
  376.       c.  Text and screens are getting cut off.
  377.  
  378.           - If you are running with a locked baud, then this could
  379.             be caused by some sort of FLOW CONTROL problem. Try using
  380.             a fossil if you aren't already.
  381.  
  382.       d.  If you're using something other than the DOOR.SYS drop file,
  383.           then I always suggest trying to use DOOR.SYS if possible. It is
  384.           the most reliable method and has had the most testing. If that
  385.           is not possible try DORINFOx.DEF as an alternative.
  386.  
  387.       e.  A door locks up node 1.  This can happen with fossils or the
  388.           internal communications routines because it uses the default
  389.           comport of 1 when NONE is found in the dropfile or game.ctl
  390.           file. To correct this make sure the right port is shown in
  391.           the dropfile OR game.ctl file.
  392.  
  393.       f.  ANSI is reflected correctly on the local screen but the user
  394.           is getting garbage.  Assuming the user has ANSI installed then
  395.           most likely the problem is at your end. First make sure you
  396.           have configured the game.ctl file to show the correct locked
  397.           port rate. Second make sure the dropfile is passing the locked
  398.           port rate INSTEAD of the actual conncet rate.  If it is not
  399.           passing the locked port rate then you may need to use a
  400.           different dropfile format OR use a dropfile converter program
  401.           to change the line to show the locked port rate INSTEAD of
  402.           the actual connect rate.
  403.  
  404.  
  405.  
  406.  
  407. SYSOP FUNCTION KEYS
  408. --------------------
  409.                         
  410.   F1  = Display available "F" Keys and what they do.
  411.   F2  = Open a scrolling chat window with the door user.
  412.   F6  = Shell out to DOS
  413.   F7  = Increments user time by 5 minutes.
  414.   F8  = Decrements user time by 5 minutes.
  415.   F10 = Ejects user from door and returns him/her to BBS after
  416.         showing a brief message.
  417.  
  418.  
  419.  
  420.  
  421. Acknowledgments and credits:
  422.  
  423.  BETA testers and other nice people :
  424.  ------------------------------------
  425.  Olle Olsson       *ideas and bug reports*   (2:203/321)
  426.  Alistair Cannon   *misspellings!*           (3:639/200)
  427.  Chris Gosley      *a zillion suggestions!*  ()
  428.  Daniel Svanström  *serious bughunter*       (2:205/246)
  429.  Michael Grigutsch *thourough bughunter!*    (2:2426/5020)
  430.  Oscar Olsson      *vicious OS/2 mastermind* (2:201/345.1)
  431.  
  432.  DDplus, the DoorDriver :
  433.  ------------------------
  434.  This relatively small section is just to recognize the GOOD people
  435.  who have made the DDPLUS based game a possibility.
  436.  
  437.  Scott Baker       -=*=-  The authors of the original DoorDriver Kit
  438.  and                       are to be thanked for releasing the
  439.  Derrick Parkhurst         source code to their great kit!  Without
  440.                            that act of kindness DDPLUS would NOT
  441.                            be possible and neither would this game.
  442.                            Scott is the author of several door games,
  443.                            most notably Land of Devastation,
  444.                            which uses the original doordriver kit.
  445.  
  446.  Steven Lorenz      -=*=- The author of the enhanced add on package
  447.                            to Scott Bakers DoorDriver Kit. Thanks to
  448.                            his code modifications, add ons and enhancements
  449.                            DDPLus is a much more complete and capable
  450.                            package then originally released in the
  451.                            DoorDriver Kit. He is also responsible for
  452.                            the DDPlus setup program which he freely donated.
  453.                            Steve is the author of several door games, most
  454.                            notably Railroad Empires, Romans At War, and
  455.                            Empires at War, all of which use DDPlus.
  456.  
  457.  Bob Dalton         -=*=- The author of most of the DDPLus documentation
  458.                            and contributor of the MISC.PAS and INITOVER.PAS
  459.                            units used in the game. Bob is the author of
  460.                            several door games, such as GodFather of Crime,
  461.                            Rise To Power, Task Force Broadside, Ship of the
  462.                            Line, Grunt Fest, Way Freight and the Adventure
  463.                            Door Game Toolkit, all of which use DDPLus.
  464.  
  465.  DESQview is a registered trademark of Quarterdeck Office Systems.
  466.  Ripscript & Ripterm are registered trademarks of TeleGrafix Communications.
  467.                    
  468.  
  469.                            Where to reach me
  470.                            -----------------
  471.  
  472.  I can usually be reached at my BBS system, which should be listed in the
  473.  section entitled "registration" which is below.
  474.  
  475.  <++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++>
  476.  
  477.  
  478.  
  479.  
  480.                                                                 
  481.  //// Always read the WHATS.NEW file for the latest news in Usurper ///
  482.  
  483. Latest version of Usurper can always be reached from my BBS:
  484. Silent Service, Fidonet (2:201/232)
  485. BBS number : +46-8-6442983
  486. FileRequests (FREQ:s) can be made under the magic name : 'USURPER'.
  487. New versions will also be hatched into the DDS net (So you won't
  488. need to call Sweden for the latest version).
  489.  
  490.  
  491.  **********************************
  492.  **** Registration Information ****
  493.  **********************************
  494. Unzip the REGISTER.ZIP archive. 
  495. Read REGISTER.USA for information on how to register in the US.
  496. Read REGISTER.CAN for information on how to register in CANADA.
  497. Read REGISTER.AUS for information on how to register in Australia.
  498. Read REGISTER.EUR for information on how to register in Europe.
  499. Read REGISTER.GER for information on how to register in Germany.
  500. Read REGISTER.SWE for information on how to register in Sweden.
  501.  
  502.  
  503. The fee will give you a registration number, which will
  504. turn your Usurper game into a fully functional game. You will never
  505. have to reregister Usurper. Your code will work with all future versions.
  506.  
  507.  
  508.  
  509. Registration Benefits
  510. ---------------------
  511.  +Access to all versions of Usurper now, and in the future.
  512.  +Access to several special places in the game.
  513.  +Access to various functions in the game editor.
  514.  +Players can go beyond the 90th dungeon level (the game can be completed). 
  515.  
  516. (I apologize for misspellings in game & docs. However, English is NOT
  517.  my native language (Swedish is).)
  518.  
  519.  
  520.  
  521.  
  522. Have Fun!  (I had some fun writing this baby.) 
  523.